home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / comm / cnet / gu40pack.lha / gu40pack / GetUserReader.README! < prev    next >
Text File  |  1997-03-21  |  5KB  |  108 lines
  1. ============================================================================
  2.                 GetUser Reader, v2.0 README! by Dotoran!
  3. ============================================================================
  4.  
  5. What Is It?
  6. ~~~~~~~~~~~
  7.     This is a short utility that will give you a command you can use from ANY
  8. prompt within CNet, in order to find what data is located IN that location.
  9. With additional arguments, you also have the power of reading this location
  10. as either the default DECIMAL value, a CHARACTER value, a HEXADECIMAL value,
  11. or a BINARY value. The CHARACTER and BINARY displays can also include a 3rd
  12. argument specifying the LENGTH of the value, as 8, 16, 24, or 32-bits.
  13.  
  14. How Do I Install It?
  15. ~~~~~~~~~~~~~~~~~~~~
  16. 1: Copy the "GetUserReader" file somewhere in your system. I suggest leaving
  17.    it in the "GU40Pack/", then copying the directory somewhere. I placed mine
  18.    in a TEXTS: path(which is what I caall my gfiles now). Also place this
  19.    README file in the same location, so as not to lose it.
  20.  
  21. 2: Add the following line to the bottom of Menu # 2, Available Everywhere,
  22.    which is found in the text file "CNET:BBSMENU":
  23.  
  24.         GU, GS      `31 | {#0<path>GetUserReader}
  25.                     |     |
  26.                     |     `--> A Control-Q Character.
  27.                     |
  28.                     `--------> Who has Access to USE this file?
  29.  
  30. 3: Now SAVE your BBSMENU file using the RAMIGA-T key combination WHILE you're
  31.    Control Panel is selected, and you'll be ready to use this command!
  32.  
  33. How Do I Use It?
  34. ~~~~~~~~~~~~~~~~
  35.     The "GU" command takes three optional arguments, as shown below:
  36.  
  37. GU value mode[<Decimal> Character Binary HeXadecimal] size[<8> 16 24 32]
  38.  
  39.     The "GS" command takes four optional arguments, as shown below:
  40.  
  41. GS id value mode[<D> C B H] size[<8> 16 24 32]
  42.  
  43.     If either command is followed using the argument "?", you will be shown
  44. a usage line for each command.
  45.  
  46.     The "id" argument, used only with the "GS" command, specifies WHICH ID
  47. Number to load into memory, BEFORE the GETSCRATCH value is read. This allows
  48. you to select ANY account to "peek into". If this argument is NOT specified,
  49. the program will ASK you which ID Number to load in.
  50.  
  51.     The "value" argument should be a valid GetUser Number:
  52.  
  53.           1 thru 102     - Predefined SHORT GetUser values.
  54.     1x00000 thru 1x15490 - Long Offsets in the PortData structure.
  55.     2x00000 thru 2x28220 - Long Offsets in the MainPort structure.
  56.     3x00000 thru 3x00573 - Long Offsets in the PortDataExtension struct.
  57.     4x00000 thru 4x00992 - Long Offsets in the MainPortExtension struct.
  58.  
  59.     If this argument is NOT given, you will be ASKED for a GetUser value once
  60. the program has loaded.
  61.  
  62.     The "mode" can either be the FIRST LETTER of the keyword, or as much of
  63. the keyword as you wish to type, as only the FIRST LETTER will be used in
  64. determining the mode. In addition, the letter "X" may be used for Hexadecimal,
  65. as well as "H". This argument determines HOW the GETUSER value will be READ
  66. and DISPLAYED to you on screen. DECIMAL will be the default mode if not given
  67. as an argument.
  68.  
  69.     The "size" argument is only valid if the MODE above is set to BINARY or
  70. CHARACTER. This value should be one of the following: 8, 16, 24, or 32. Any
  71. OTHER value specified will be converted to an "8". The value of "8" will
  72. also be used as the default if this argument is NOT given.
  73.  
  74. Once all data has been entered, you will be shown a line similar to below:
  75.  
  76. [????] GetUser    "???" yields: [???]
  77.   |    GetScratch   |             |
  78.   |                 |             `--> The contents of this GetUser Location.
  79.   |                 |
  80.   |                 `----------------> The GetUser "value" you specified.
  81.   |
  82.   `----------------------------------> DEC - If "mode" set to: DECIMAL
  83.                                        BIN - If "mode" set to: BINARY
  84.                                        HEX - If "mode" set to: HEXADECIMAL
  85.                                       CHAR - If "mode" set to: CHARACTER
  86.  
  87. Some Examples of GU's & GS's Usage:
  88.  
  89.     GU 38                         : The User's WHO Banner.
  90.     GU 29                         : Ascii Code of User's Protocol.
  91.     GU 29 H                       : Protocol HEX Value, used in "bbs.udata".
  92.     GU 29 C                       : More Familiar LETTER of Protocol.
  93.     GU 1400664                    : Download Bytes Allowed PER DAY.
  94.     GU 1400648 B 32               : The User's Message Base Flags.
  95.     GU 1100660 BIN 8              : The User's ABIT0 Bank of Priviledges.
  96.  
  97.     GS 2 38                       : Load ID # 2's Who Banner.
  98.     GS 5 29 C                     : Show ID # 5's Protocol Letter.
  99.     GS 17 1400648 Binary 32       : Show ID # 17's Message Base Flags.
  100.  
  101. And that's all there is to using the GetUser Reader. If you have any questions,
  102. comments, or criticisims, I'd love to hear from you. Until then, Au Revoir!
  103.  
  104.                                                                   - Dotoran
  105. ============================================================================
  106.       Feeling hot? Catch my Waves>  http://www.bluemoon.net/~dotoran
  107. ============================================================================
  108.